home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Users Group Library 1996 July / C-C++ Users Group Library July 1996.iso / vol_400 / 414_02 / portable / wattrset.c < prev    next >
Encoding:
C/C++ Source or Header  |  1993-06-17  |  2.3 KB  |  71 lines
  1. #define    CURSES_LIBRARY    1
  2. #include <curses.h>
  3. #undef    wattrset
  4.  
  5. #ifdef PDCDEBUG
  6. char *rcsid_wattrset = "$Header: C:\CURSES\portable\RCS\wattrset.c 2.1 1993/06/18 20:21:33 MH Rel MH $";
  7. #endif
  8.  
  9.  
  10.  
  11.  
  12. /*man-start*********************************************************************
  13.  
  14.   wattrset()    - attribute manipulation
  15.  
  16.   X/Open Description:
  17.      These functions manipulate the current attributes of the named
  18.      window.  These attributes can be any combination of A_STANDOUT,
  19.      A_REVERSE, A_BOLD, A_DIM, A_BLINK, A_UNDERLINE.
  20.  
  21.      These constants are defined in <curses.h> and can be combined
  22.      with the bitwise-OR operator (|).
  23.  
  24.      The current attributes of a window are applied to all characters
  25.      that are written into the window with waddch().  Attributes are
  26.      a property of the character, and move with the character
  27.      through any scrolling and insert/delete line/character operations.
  28.      To the extent possible on the particular terminal, they will be
  29.      displayed as the graphic rendition of characters put on the
  30.      screen.
  31.  
  32.      The attrset() function sets the current attributes of the given
  33.      window to attrs.  The attroff() function turns off the named
  34.      attributes without turning on or off any other attributes.  The
  35.      attron() function turs on the named attriutes without affecting
  36.      any others.  The standout function is the same as
  37.      attron( A_STANDOUT ).  The standend() function is the same as
  38.      attrset( 0 ); that is it turns off all attributes.
  39.  
  40.      NOTE:  attroff(), attron() and attrset() are macros.
  41.  
  42.   PDCurses Description:
  43.      System V compatible color support is included.
  44.      See <curses.h> for further details.
  45.  
  46.   X/Open Return Value:
  47.      These functions return OK on success and ERR on error.
  48.  
  49.   PDCurses Errors:
  50.      It is an error to call this function with a NULL window pointer.
  51.  
  52.   Portability:
  53.      PDCurses    int wattrset( WINDOW* win, int attrs );
  54.      X/Open Dec '88    int wattrset( WINDOW* win, int attrs );
  55.      BSD Curses    int wattrset( WINDOW* win, int attrs );
  56.      SYS V Curses    int wattrset( WINDOW* win, int attrs );
  57.  
  58. **man-end**********************************************************************/
  59.  
  60. int    wattrset(WINDOW *win, int attrs)
  61. {
  62. #ifdef PDCDEBUG
  63.     if (trace_on) PDC_debug("wattrset() - called\n");
  64. #endif
  65.  
  66.     if (win == (WINDOW *)NULL)
  67.         return( ERR );
  68.     win->_attrs = attrs & A_ATTRIBUTES;
  69.     return( OK );
  70. }
  71.